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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under www.etsi.org/kev . 
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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document defines a transport protocol for use in the IP multimedia (IM) Core Network (CN) subsystem 
based on Diameter. 

The present document is applicable to: 

The Sh interface between an AS and the HSS. 

The Sh interface between an SCS and the HSS. 

Whenever it is possible this document specifies the requirements for this protocol by reference to specifications 
produced by the IETF within the scope of Diameter. Where this is not possible, extensions to Diameter are defined 
within this document. 



2 References 

The following documents contain provisions, which through reference in this text constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.328 "IP Multimedia (IM) Subsystem Sh interface; signalling flows and message contents (Release 

5)" 

[2] 3GPP TS 33.210 "3G Security; Network Domain Security; IP Network Layer Security (Release 5)" 

[3] IETF RFC 2960 "Stream Control Transmission Protocol" 

[4] draft-ietf-aaa-diameter-10.txt, "Diameter Base Protocol", work in progress 

[5] IETF RFC 2234 "Augmented BNF for syntax specifications" 

[6] 3GPP TS 29.229 "Cx and Dx Interfaces based on the Diameter protocol; protocol details (Release 5)" 

3 Definitions, symbols and abbreviations 
3.1 Definitions 

Refer to [4] for the definitions of some terms used in this document. 

For the purposes of the present document, the following terms and definitions apply. 

Attribute- Value Pair: see [4], it corresponds to an Information Element in a Diameter message. 

Server: SIP-server. 

User data: user profile data. 
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3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AAA Authentication, Authorization and Accounting 

AS Application Server 

ABNF Augmented Backus-Naur Form 

AVP Attribute-Value Pair 

CN Core Network 

HSS Home Subscriber Server 

lANA Internet Assigned Numbers Authority 

IETF Internet Engineering Task Force 

IMS IP Multimedia Subsystem 

NDS Network Domain Security 

RFC Request For Comment 

SCTP Stream Control Transport Protocol 

UCS Universal Character Set 

URL Uniform Resource Locator 

UTF UCS Transformation Formats 



4 General 

The Diameter Base Protocol as specified in [4] shall apply except as modified by the defined support of the methods 
and the defined support of the commands and AVPs, result and event codes specified in clause 5 of this specification. 
Unless otherwise specified, the procedures (including error handling and unrecognised information handling) are 
unmodified. 



Use of the Diameter base protocol 



The same clarifications of section 5 of 3GPP TS 29.229 [6] shall apply to the Sh interface. An exception is that the 
application identifier for this application is defined in chapter 6. 



6 Diameter application for Sh interface 

This clause specifies a Diameter application that allows a Diameter server and a Diameter client: 

to download and update transparent and non-transparent user data 

to request and send notifications on changes on user data 

The Sh interface protocol is defined as an IETF vendor specific Diameter application, where the vendor is 3GPP. The 
vendor identifier assigned by lANA to 3GPP ( http://www.iana.org/assignments/enterprise-numbers ) is 10415. 

The Diameter application identifier assigned to the Sh interface protocol is number 2. 

6.1 Command-Code values 

This section defines Command-Code values for this Diameter application. 

Every command is defined by means of the ABNF syntax [5], according to the rules in [4]. Whenever the definition and 
use of an AVP is not specified in this document, what is stated in [4] or [6] shall apply. 

The following Command Codes are defined in this specification: 
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Table 6.1.1 : Command-Code values 



Command-Name 


Abbreviation 


Code 


Section 


User-Data-Request 


UDR 


1 


6.1.1 


User-Data- Answer 


UDA 


1 


6.1.2 


Profile-Update-Request 


PUR 


2 


6.1.3 


Profile-Update-Answer 


PUA 


2 


6.1.4 


Subscribe-Notifications-Request 


SNR 


3 


6.1.5 


Subscribe-Notifications-Answer 


SNA 


3 


6.1.6 


Push-Notification-Request 


PNR 


4 


6.1.7 


Push-Notification- Answer 


PNA 


4 


6.1.8 



6.1 .1 User-Data-Request (UDR) Command 

The User-Data-Request (UDR) command, indicated by the Command-Code field set to 1 and the 'R' bit set in the 
Command Flags field, is sent by a Diameter client to a Diameter server in order to request user data. 



Message Format 



< User-Data -Request> ::= 



< Diameter Header: 10415: 1, REQ, PXY > 
< Session-Id > 

{ Vendor-Specific-Application-Id } 
{ Auth-Session-State } 
{ Origin-Host } 
{ Origin-Realm } 
[ Destination-Host ] 
{ Destination-Realm } 
{ User-Identity } 
[ Service-Indication ] 
1*[ Data-Reference ] 
*[ Requested-Domain ] 
[ Current-Location ] 
*[ AVP ] 
*[ Proxy-Info ] 
*[ Route-Record ] 



6.1 .2 User-Data-Answer (UDA) Command 



The User-Data-Answer (SAA) command, indicated by the Command-Code field set to 1 and the 'R' bit cleared in the 
Command Flags field, is sent by a server in response to the User-Data-Request command. The Result-Code or Vendor- 
Specific-Result AVP may contain one of the values defined in section 6.2 in addition to the values defined in [6]. 



Message Format 



< User-Data- Answer > ::= 



< Diameter Header: 10415: 1 > 
< Session-Id > 

{ Vendor-Specific-Application-Id 
[ Result-Code ] 
[ Vendor-Specific-Result ] 
{ Auth-Session-State } 
{ Origin-Host } 
{ Origin-Realm } 
[ User-Data ] 
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*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .3 Profile-Update-Request (PUR) Command 

The Profile-Update-Request (PUR) command, indicated by the Command-Code field set to 2 and the 'R' bit set in the 
Command Flags field, is sent by a Diameter client to a Diameter server in order to update user data in the server. 

Message Format 

< Profile-Update-Request > ::= < Diameter Header: 10415: 2, REQ, PXY > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

{ Destination-Host } 

{ Destination-Realm } 

{ Public-Identity } 

{ User-Data } 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .4 Profile-Update-Answer (PUA) Command 

The Profile-Update-Answer (PUA) command, indicated by the Command-Code field set to 2 and the 'R' bit cleared in 
the Command Flags field, is sent by a client in response to the Profile-Update-Request command. The Result-Code or 
Vendor-Specific-Result AVP may contain one of the values defined in section 6.2 in addition to the values defined in 
[6]. 

Message Format 

< Profile-Update-Answer > ::=< Diameter Header: 10415: 2 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

[ Result-Code ] 

[ Vendor-Specific-Result ] 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .5 Subscribe-Notifications-Request (SNR) Command 

The Subscribe-Notifications-Request (SNR) command, indicated by the Command-Code field set to 3 and the 'R' bit 
set in the Command Flags field, is sent by a Diameter client to a Diameter server in order to request notifications of 
changes in user data. 

Message Format 

< Subscribe-Notifications-Request > ::= < Diameter Header: 10415: 3, REQ, PXY > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

[ Destination-Host ] 

{ Destination-Realm } 

{ Public-Identity } 
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[ Service-Indication] 
{ Subs-Req-Type } 
1*[ Data-Reference ] 
*[ AVP ] 
*[ Proxy-Info ] 
*[ Route-Record ] 

6.1 .6 Subscribe-Notifications-Answer (SNA) Command 

The Subscribe-Notifications-Answer command, indicated by the Command-Code field set to 2 and the 'R' bit cleared in 
the Command Flags field, is sent by a client in response to the Subscribe-Notifications-Request command. The Result- 
Code or Vendor-Specific-Result AVP may contain one of the values defined in section 6.2 in addition to the values 
defined in [6]. 

Message Format 

< Subscribe-Notifications-Answer > ::= < Diameter Header: 10415: 3 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

[ Result-Code ] 

[ Vendor-Specific-Result ] 

{ Origin-Host } 

{ Origin-Realm } 

*[ Data-Reference ] 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .7 Push-Notification-Request (PNR) Command 

The Push-Notification-Request (PNR) command, indicated by the Command-Code field set to 1 and the 'R' bit set in 
the Command Flags field, is sent by a Diameter server to a Diameter client in order to notify changes in the user data in 
the server. 

Message Format 

< Push-Notification-Request > ::= < Diameter Header: 10415: 4, REQ, PXY > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

{ Destination-Host } 

{ Destination-Realm } 

{ Public-Identity } 

{ User-Data } 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .8 Pusln-Notifications-Answer (PNA) Command 

The Push-Notifications-Answer (PNA) command, indicated by the Command-Code field set to 2 and the 'R' bit cleared 
in the Command Flags field, is sent by a client in response to the Push-Notification-Request command. The Result- 
Code or Vendor-Specific-Result AVP may contain one of the values defined in section 6.2 in addition to the values 
defined in [6]. 

Message Format 

< Push-Notification-Answer > ::=< Diameter Header: 10415: 4 > 

< Session-Id > 
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{ Vendor-Specific-Application-Id } 

[ Result-Code ] 

[ Vendor-Specific-Result ] 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.2 Result-Code AVP values 

This section defines new result code values that must be supported by all Diameter implementations that conform to this 
specification. The result codes defined in 3GPP TS 29.229 are also applicable. When one of the result codes defined 
here is included in a response, it shall be inside a Vendor-Specific-Result AVP and Result-Code AVP shall be absent. 

6.2.1 Success 

Errors that fall within the Success category are used to inform a peer that a request has been successfully completed. 
No errors within this category have been defined so far. 

6.2.2 Permanent Failures 

Errors that fall within the Permanent Failures category are used to inform the peer that the request failed, and should not 
be attempted again. 

6.2.2.DIAMETER_USER_DATA_NOT_RECOGNIZED (51 00) 

The data required, in the XLM schema, does not match that which is specified within the HSS. 

DIAMETER_OPERATION_NOT_ALLOWED (51 01 ) 

The requested operation is not allowed for the user 

DIAMETER_USER_DATA_CANNOT_BE_READ (51 02) 

The requested user data is not allowed to be read. 

DIAMETER_USER_DATA_CANNOT_BE_MODIFIED (51 03) 
The requested user data is not allowed to be modified 

DIAMETER_USER_DATA_CANNOT_BE_NOTIFIED (51 04) 

The requested user data is not allowed to be notified on changes 

6.2.3 Transient Failures 

Errors that fall within the transient failures category are those used to inform a peer that the request could not be 
satisfied at the time that it was received. The request may be able to be satisfied in the future. 



6.2.3.1 DIAMETER_USER_DATA_NOT_AVAILABLE (4100)The requested user data is not available at this time to 
satisfy the requested operation. 
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6.3 AVPs 

The following table describes the Diameter AVPs defined for the Sh interface protocol, their AVP Code values, types, 
possible flag values and whether the AVP may or not be encrypted. 

Table 6.3.1 : Diameter Multimedia Application AVPs 











AVP Flag rules 




Attribute Name 


AVP 

Code 


Section 
defined 


Value Type 


Must 


May 


Should 
not 


Must 
not 


May 
Encr. 


User-Identity 


100 


6.3.1 


Grouped 


M, V 








N 


MSISDN 


101 


6.3.2 


OctetString 


M, V 








N 


User-Data 


102 


6.3.3 


OctetString 


M, V 








N 


Data-Reference 


103 


6.3.4 


Enumerated 


M, V 










Service-Indication 


104 


6.3.5 


OctetString 


M, V 








N 


Subs-Req-Type 


105 


6.3.6 


Enumerated 


M, V 








N 


Requested-Domain 


106 


6.3.7 


Enumerated 


M, V 








N 


Current-Location 


107 


6.3.8 


Enumerated 


M, V 








N 


NOTE 1: The AVP header bit denoted as 'M', indicates whether support of the AVP is required. The AVP header 
bit denoted as 'V, indicates whether the optional Vendor-ID field is present in the AVP header. For further 
details, see [6]. 

NOTE 2: Depending on the concrete command. 



6.3.1 User-Identity AVP 

The User-Identity AVP (AVP Code 100) is of type Grouped. This AVP contains a user public identity. 
AVP format 

User-Identity ::= <AVP header: 100 10415> 

* [Public-Identity] 

*[MSISDN] 

*[AVP] 

6.3.2 MSISDN AVP 

The MSISDN AVP (AVP Code 101) is of type OctetString. This AVP contains an MSISDN with the format described 
in 3GPP TS 23.003. 

6.3.3 User-Data AVP 

The User-Data AVP (AVP Code 102) is of type OctetString. This AVP contains the user data requested in the UDR and 
SNR operations and the data to be modified in the UPR operation . The exact content and format of this AVP is 
described in 3GPP TS 29.328 [1]. 
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6.3.4 Data-Reference AVP 

The Data-Reference AVP (AVP code 103) is of type Enumerated, and indicates the type of the requested user data in 
the operation UDR and SNR. Its exact values and meaning is defined in 3GPP TS 29.328. The following values are 
defined (more details are given in 3GPP TS 29.328): 

RepositoryData (0) 

PubUcldentifiers (10) 

This value is used to request the read or notification of changes in the IMS public identities fields 

RegistrationState (11) 

S-CSCFName (12) 

InitialFilterCriteria (13) 

Locationlnformation (14) 



6.3.5 Service-Indication AVP 

The Service-Indication AVP (AVP code 104) is of type OctetString. This AVP contains the Service Indication that 
identifies a service in an AS. 

6.3.6 Subs-Req-Type AVP 

The Subs-Req-Type AVP (AVP code 105) is of type Enumerated, and indicates the type of the subscription-to- 
notifications request. The following values are defined: 

Subscribe (0) 

This value is used by an AS to subscribe to notifications of changes in data. 
Unsubscribe (1) 

This value is used by an AS to unsubscribe to notifications of changes in data. 



6.3.7 Requested-Domain AVP 



The Requested-Domain AVP (AVP code 106) is of type Enumerated, and indicates the access domain for which certain 
data (e.g. user state) are requested. The following values are defined: 

CS -Domain (0) 

The requested data apply to the CS domain. 
PS-Domain (1) 

The requested data apply to the PS domain. 

6.3.8 Current-Location AVP 

The Current-Location AVP (AVP code 107) is of type Enumerated, and indicates whether an active location retrieval 
has to be initiated or not: 

DoNotNeedlnitiateActiveLocationRetrieval (0) The request indicates that the initiation of an active location 
retrieval is required. 

Initiate ActiveLocationRetrieval ( 1 ) 

It is requested that an active location retrieval is initiated. 
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6.4 Use of namespaces 



This clause contains the namespaces that have either been created in this specification, or the values assigned to existing 
namespaces managed by IAN A. 

This specification assigns the values 1-4 from the Command Code namespace managed by 3GPP for its Diameter 
vendor- specific application number 2. See section 6.1 for the assignment of the namespace in this specification. 

6.4.1 AVP codes 

This specification assigns the values 100-107 from the AVP Code namespace managed by 3GPP for its Diameter 
vendor-specific application number 2. See section 6.3 for the assignment of the namespace in this specification. 

6.4.2 Vendor-Specific-Result-Code AVP values 

This specification has assigned Vendor-Specific-Result-Code AVP values 4100 and 5100-5104. See section 6.2. 



Special Requirements 



7.1 Version Control 

The same mechanisms specified in 3GPP TS 29.229 [6] apply to this specification. 
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Annex A (informative): 
Change history 



Date 


TSG# 


TSG Doc. 


CR# 


Rev 


Subject/Comment 


In 


Out 
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2.0.1 


5.0.0 


Sep 2002 


CN#17 


NP-020450 


2 


1 


Cancellation of subscriptions to notifications 


5.0.0 


5.1.0 


Sep 2002 


CN#17 


NP-020450 


3 


1 


Addition of AVPs to User-Data-Request 


5.0.0 


5.1.0 
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